home *** CD-ROM | disk | FTP | other *** search
/ EnigmA Amiga Run 1997 April / EnigmA AMIGA RUN 17 (1997)(G.R. Edizioni)(IT)[!][issue 1997-04][EAR-CD].iso / EARCD / util / misc / MonSpecsMUI.readme < prev    next >
Text File  |  1997-01-05  |  14KB  |  356 lines
  1. Short:    Change overscan/monitor values, V40.286
  2. Author:   Thomas Krafzik
  3. Uploader: Martin Schulze <schulze@phil.uni-sb.de>
  4. Type:     util/misc
  5. Kurz:     Overscan-/Monitor-Werte verändern, V40.286
  6. Requires: OS 3.0 or higher
  7. Replaces: MonSpecsMUI40276.lha
  8.  
  9. DISCLAIMER:
  10. ------------------------------------------------------------------------
  11. This is FREEWARE.
  12. Distribution on Aminet or Aminet-CD's is always OK.
  13. Distribution by Fred Fish is always OK.
  14. Distribution on MeetingPearlsCD's is always OK.
  15. Other commercial distribution without written permission from me
  16. is strictly forbidden.
  17. Distribution is only allowed if the archive is left untouched.
  18. If you are a rascist or a fascist or have other racial prejudices,
  19. you are encouraged to earn some money and buy yourself a BRAIN.
  20. Oh, yes, you are NOT allowed to use this program, of course.
  21. ------------------------------------------------------------------------
  22.  
  23. MonSpecsMUI is copyright 1995/96 by Thomas Krafzik.
  24.  
  25.  
  26. IMPORTANT NOTE:
  27. ------------------------------------------------------------------------
  28.       THIS PROGRAM CAN DESTROY YOUR MONITOR !!!
  29.  
  30.       You shouldn't use this program if you are a beginner.
  31.       This program may destroy your monitor if you use it incorrectly
  32.       (specially changes of "TotClk"/"TotRow")
  33.       Please be careful with the settings for BEAMCON0, also.
  34.  
  35.       You had been warned !
  36.  
  37.       I'm not responsible for any damages this program does.
  38.       (Obviously it shouldn't do any)
  39. ------------------------------------------------------------------------
  40.  
  41.  
  42.  
  43. MUI NOTE:
  44. ------------------------------------------------------------------------
  45.              This application uses
  46.  
  47.  
  48.             MUI - MagicUserInterface
  49.  
  50.         (c) Copyright 1992-96 by Stefan Stuntz
  51.  
  52.  
  53. MUI is a system to generate and maintain graphical user interfaces. With
  54. the  aid  of  a  preferences program, the user of an application has the
  55. ability to customize the outfit according to his personal taste.
  56.  
  57. MUI is distributed as shareware. To obtain a complete package containing
  58. lots of examples and more information about registration please look for
  59. a  file  called  "muiXXusr.lha"  (XX means the latest version number) on
  60. your local bulletin boards or on public domain disks.
  61.  
  62.       If you want to register directly, feel free to send
  63.  
  64.  
  65.              DM 30.-  or  US$ 20.-
  66.  
  67.                   to
  68.  
  69.                  Stefan Stuntz
  70.             Eduard-Spranger-Straße 7
  71.                  80935 München
  72.                 GERMANY
  73. ------------------------------------------------------------------------
  74.  
  75. Hello,
  76. this is a program like MonED (by Raul A. Sobon), but uses MUI.
  77. You can change the same parameters like MonEd plus Nominal-, Maximal-,
  78. and Video-Overscan settings, flags possible with the BeamCon0-ToolType,
  79. some View parameters (Position/Range), and you can call the functions
  80. which are embedded in structs MonitorSpec/SpecialMonitor.
  81. Of course, you can save all of this settings in the icons of the monitor
  82. drivers in the drawer "DEVS:Monitors".
  83. You could theoretically save upto 4 Mrd different settings.
  84. These different settings contain Overscan, ModeName, Properties, ViewPosition,
  85. and ViewPositionRange settings.
  86. The other tooltypes are always stored only once.
  87.  
  88. In the left area of the window there are some informations about the actual
  89. screen mode, and you can switch to another open public screen or to a
  90. self-defined (via ASL requester) private screen.
  91.  
  92. Additionally you will find the program "ChangeHWOverscan" in the distribution,
  93. which reads the tooltypes found in the monitor icons and activates them.
  94. You should place this program in the user-startup, no need to run it, no need
  95. to send output to NIL:.
  96. It has no parameters and scans the entire "DEVS:Monitors/" directory.
  97.  
  98.  
  99. normal calling:
  100. ---------------
  101. ChangeHWOverscan ; this line in user-startup
  102.  
  103.  
  104. if you notice that it doesn't seem to respect your settings, try:
  105. -----------------------------------------------------------------
  106. ChangeHWOverscan        ; user-startup
  107. SYS:Prefs/Overscan USE  ; user-startup
  108.  
  109. this is e.g. necessary if you use the "Multiscan" monitor driver from WB3.1
  110. (Thanks must go to Martin Hilpert for reporting this)
  111.  
  112. START THIS PROGRAM ONLY IF THE MONITOR DRIVERS ARE ALREADY LOADED.
  113.  
  114. Saved Tooltypes:
  115. ----------------
  116. TOTCLKS=0x<Hex>            total colorclocks
  117. TOTROWS=0x<Hex>            total rows
  118. MINROW=0x<Hex>             display start row
  119. MINCOL=0x<Hex>             display start column
  120. BEAMCON0=0x<Hex>           beamcon0 flags
  121. HBSTRT=0x<Hex>             horizontal blank start (>0 !!!)
  122. HBSTOP=0x<Hex>             horizontal blank stop
  123. HSSTRT=0x<Hex>             horizontal sync start (not used)
  124. HSSTOP=0x<Hex>             horizontal sync stop (not used)
  125. VBSTRT=0x<Hex>             vertical blank start
  126. VBSTOP=0x<Hex>             vertical blank stop
  127. VSSTRT=0x<Hex>             vertical sync start (not used)
  128. VSSTOP=0x<Hex>             vertical sync stop (not used)
  129. MODEID0=0x<HexID>          standard amiga mode id
  130. NOMMINX0=<Integer>         minimum nominal overscan x value
  131. NOMMAXX0=<Integer>         maximum nominal overscan x value
  132. NOMMINY0=<Integer>         minimum nominal overscan x value
  133. NOMMAXY0=<Integer>         maximum nominal overscan x value
  134. MAXMINX0=<Integer>         minimum maximal overscan x value
  135. MAXMAXX0=<Integer>         maximum maximal overscan x value
  136. MAXMINY0=<Integer>         minimum maximal overscan x value
  137. MAXMAXY0=<Integer>         maximum maximal overscan x value
  138. VIDEOMINX0=<Integer>       minimum video overscan x value
  139. VIDEOMAXX0=<Integer>       maximum video overscan x value
  140. VIDEOMINY0=<Integer>       minimum video overscan x value
  141. VIDEOMAXY0=<Integer>       maximum video overscan x value
  142. VPRMINX0=<Integer>         minimum ViewPositionRange x value
  143. VPRMAXX0=<Integer>         maximum ViewPositionRange x value
  144. VPRMINY0=<Integer>         minimum ViewPositionRange y value
  145. VPRMAXY0=<Integer>         maximum ViewPositionRange y value
  146. VPOSX0=<Integer>           ViewPosition x value
  147. VPOSY0=<Integer>           ViewPosition y value
  148. MODENAME0=<String>         ModeName
  149. PROPERTIES0=0x<Hex>        Interlace a.s.o.
  150. MODEID1=...
  151. NOMMINX1=...
  152. and so on
  153.  
  154.  
  155. Program ToolTypes:
  156. ------------------
  157. NEWHZ=TRUE|FALSE           activates other calculation of Hz/kHz values.
  158.                (DEFAULT: FALSE)
  159.  
  160. BIGGUI                     NO LONGER SUPPORTED !
  161.  
  162. MIN_HB                     define lower bound of HBStrt/HBStop slider
  163.                (DEFAULT: 0)
  164.  
  165. MAX_HB                     define upper bound of HBStrt/HBStop slider
  166.                (DEFAULT: 63)
  167.  
  168. MIN_HS                     define lower bound of HSStrt/HSStop slider
  169.                (DEFAULT: 0)
  170.  
  171. MAX_HS                     define upper bound of HSStrt/HSStop slider
  172.                (DEFAULT: 63)
  173.  
  174. MIN_VB                     define lower bound of VBStrt/VBStop slider
  175.                (DEFAULT: 0)
  176.  
  177. MAX_VB                     define upper bound of VBStrt/VBStop slider
  178.                (DEFAULT: 7999)
  179.  
  180. MIN_VS                     define lower bound of VSStrt/VSStop slider
  181.                (DEFAULT: 0)
  182.  
  183. MAX_VS                     define upper bound of VSStrt/VSStop slider
  184.                (DEFAULT: 7999)
  185.  
  186. MIN_TOTROW                 define lower bound of TotRow        slider
  187.                (DEFAULT: 0)
  188.  
  189. MAX_TOTROW                 define upper bound of TotRow        slider
  190.                (DEFAULT: 767)
  191.  
  192. MIN_TOTCLK                 define lower bound of TotClk        slider
  193.                (DEFAULT: 0)
  194.  
  195. MAX_TOTCLK                 define upper bound of TotClk        slider
  196.                (DEFAULT: 767)
  197.  
  198. MIN_DIM                    define lower bound of Overscan      sliders
  199.                (DEFAULT: -511)
  200.  
  201. MAX_DIM                    define upper bound of Overscan      sliders
  202.                (DEFAULT: 1023)
  203.  
  204. MIN_VIEW                   define lower bound of VPRMinX.../VPosX.
  205.                and MinCol/MinRow sliders
  206.                (DEFAULT: -255)
  207.  
  208. MAX_VIEW                   define upper bound of VPRMinX.../VPosX.
  209.                and MinCol/MinRow sliders
  210.                (DEFAULT: 2047)
  211.  
  212. LEAVESCREENREQ=TRUE|FALSE  if you leave an editable (native) screen, a requester
  213.                which asks you if you will SAVE|USE|CANCEL your
  214.                settings popups appears (DEFAULT: FALSE)
  215.  
  216. CUSTOMSCRMINWIDTH          your defined private screens should have this
  217.                minimum width so you must not change the contents
  218.                of the integer gadgets by hand if you select
  219.                some exotic modes from the list (and your window
  220.                will not be crumbled with a topaz/4 font or
  221.                something awfully... But I suggest that you leave
  222.                autoscroll on in these cases.  (DEFAULT: 640)
  223.  
  224. CUSTOMSCRMINHEIGHT         the same for screen min height (DEFAULT: 480)
  225.  
  226. SMREQ_HEIGHT               initial height of screen mode requester
  227.                (DEFAULT: 300)
  228.  
  229. CUSTOMSCRDEPTH             you can give a preset value for the depth gadget
  230.                of the screenmode requester, so you don't have
  231.                to manually move the slider every time you
  232.                define a new screen. This is useful if you have
  233.                some fancy background patterns in your window.
  234.                (DEFAULT: 2)
  235.  
  236. Changes for 40.286:
  237. -------------------
  238. - fixed vertical diffs from actual y-size test gadgets
  239. - if you start the program with another DefaultPubScreen as Workbench,
  240.   the program was confused. (Thanks to pja@sip.fi for the bug report)
  241. - fixed ModeName: if a modeid had no nameinfo you couldn't set a new name.
  242. - now VSSTRT/VSSTOP sliders show their values relative to TOTCLK through new
  243.   MUI custom class
  244. - SAS/C inserted break checking code, although I disabled it in the options
  245.   Now this code should be finally gone.
  246. - other internal changes
  247.  
  248.  
  249. Changes for 40.276:
  250. -------------------
  251. - extended program "ChangeHWOverscan" (also in this archive) to
  252.   accept new tooltypes (MODENAME, PROPERTIES)
  253. - "ChangeHWOverscan" now sets also the syncs (HSSTRT, HSSTOP, VSSTRT, VSSTOP)
  254.   which are saved by "MonSpecsMUI"
  255. - dropped BIGGUI tooltype support (SMALLGUI gone), if you want it back, tell me
  256. - eliminated ...-button
  257. - Properties-Register
  258. - ModeName-Register
  259. - cleaned up the source a lot (as always...)
  260. - silly bug: saved HBSTRT twice, instead of HBSTRT & HBSTOP, SORRY !
  261. - new catalog version (4)
  262.  
  263. Changes for 40.257:
  264. -------------------
  265. - new tooltypes: SMREQ_HEIGHT, CUSTOMSCRMINWIDTH, CUSTOMSCRMINHEIGHT,
  266.          LEAVESCREENREQ, CUSTOMSCRDEPTH, MIN_VIEW, MAX_VIEW,
  267. - removed tooltypes: MIN_MIN, MIN_MAX (replaced thru MIN_VIEW, MAX_VIEW)
  268. - added definition of own screen via asl screenmoderequester
  269. - added a gadget for monitor properties of current screen
  270. - added ViewPosition sliders
  271. - added ViewPositionRange sliders
  272. - memory allocation now goes through exec MemoryPools
  273.   (please use the latest available "SetPatch" command you find
  274.    on Aminet)
  275. - now you can save any number of settings in the monitor driver icons,
  276.   the silly limit of 8 settings is completely gone
  277. - now locks the actual public screen to prevent a crash if
  278.   you uniconify to a already closed screen
  279. - replaced tab-cycling of slider gadgets thru direct keys
  280. - MinCol/MinRow moved to the "View" page
  281. - fixed bug that occurs when using internal strings, no catalog installed
  282.   (about requester, menu "simulate")
  283. - reads icon tooltypes even if started from CLI now,
  284.   CLI parameters, if given, "override" these settings.
  285. - memory allocation bug in tooltype save routine fixed
  286. - forgot to close the monitor that I had opened
  287. - cleaned up object id's (MUI gui prefs method)
  288. - changed behaviour for NTSC/PAL
  289. - extended program "ChangeHWOverscan" (also in this archive) to
  290.   accept new tooltypes
  291. - cleaned up the source a lot (as always...)
  292.  
  293.  
  294. Known Bugs:
  295. -----------
  296. 1. The VPRMinX/VPRMaxX/VPRMinY/VPRMaxY values you can edit seemed
  297.    to be really hardware given, so that changing them could be senseless.
  298.    My original intention to implement this was to bypass a problem in
  299.    horizontal overscan settings (invisible right area) and to have greater
  300.    flexibility in VPosX/VPosY (ViewPosition) settings.
  301.  
  302. 2. VPosX/VPosY changes only shows up when you click the screen back and
  303.    then to front again. I don't know why this is so. (maybe I should do
  304.    some view updating)
  305.  
  306.  
  307. Please read also the .readme file for ChangeHWOverscan.
  308.  
  309.  
  310. My Address:
  311. Thomas Krafzik
  312. Belforter Str. 20
  313. 45884 Gelsenkirchen
  314. Germany
  315.  
  316. Phone: (+49)209 12386 (international)
  317.        0209 12386 (german)
  318.  
  319. EMail: Kenwood@Focus.RUHR.DE  (<-- NEW !)
  320.  
  321. If you have any questions or want to report a bug (käfer), you can contact me
  322. by phone or snail mail or the supplied email address.
  323. The EMail address I gave in the previous release is NO LONGER valid,
  324. cause BFZ-Box was closed down due to money problems.
  325.  
  326. If you send mail and expect an answer, include return postage also.
  327. AirMail to USA costs 2$ or 3DM.
  328.  
  329. Thank you.
  330.  
  331.  
  332. ============================= Archive contents =============================
  333.  
  334. Original  Packed Ratio    Date     Time    Name
  335. -------- ------- ----- --------- --------  -------------
  336.     1233     597 51.5% 24-Nov-96 12:05:14 +deutsch.info
  337.     7356    2617 64.4% 14-Nov-96 18:09:36 +MonSpecsMUI.cd
  338.     1545     621 59.8% 24-Nov-96 12:05:14 +MonSpecsMUI.cd.info
  339.     5338    2202 58.7% 14-Nov-96 18:12:32 +MonSpecsMUI.catalog
  340.     6890    2415 64.9% 14-Nov-96 18:11:22 +MonSpecsMUI_D.ct
  341.     1545     618 60.0% 14-Nov-96 18:11:22 +MonSpecsMUI_D.ct.info
  342.     1233     589 52.2% 01-Dec-96 14:12:56 +Catalogs.info
  343.    58308   27267 53.2% 01-Dec-96 14:05:48 +MonSpecsMUI
  344.     2060    1085 47.3% 01-Dec-96 14:12:56 +MonSpecsMUI.info
  345.    12714    4914 61.3% 01-Dec-96 13:39:38 +MonSpecsMUI.liesmich
  346.     5664    3048 46.1% 24-Nov-96 01:34:04 +ChangeHWOverscan
  347.     1816    1296 28.6% 01-Dec-96 14:12:56 +MonSpecsMUI.liesmich.info
  348.    12421    4738 61.8% 01-Dec-96 13:36:12 +MonSpecsMUI.readme
  349.     1857    1340 27.8% 01-Dec-96 14:12:56 +MonSpecsMUI.readme.info
  350.     1233     595 51.7% 01-Dec-96 14:12:48  MonSpecsMUI40.286.info
  351.     1667     884 46.9% 01-Dec-96 14:12:56 +ChangeHWOverscan.info
  352.     3327    1339 59.7% 24-Nov-96 11:42:36 +ChangeHWOverscan.readme
  353.     1816    1298 28.5% 01-Dec-96 14:12:56 +ChangeHWOverscan.readme.info
  354. -------- ------- ----- --------- --------
  355.   128023   57463 55.1% 21-Dec-96 14:33:14   18 files
  356.